Skip to content

Feature/update docs - #32

Merged
jonmarks12 merged 18 commits into
mainfrom
feature/update_docs
Apr 7, 2026
Merged

Feature/update docs#32
jonmarks12 merged 18 commits into
mainfrom
feature/update_docs

Conversation

@jonmarks12

Copy link
Copy Markdown
Collaborator

Docs overhaul: theme, content, and RST fixes

Rewrites and expands the Sphinx documentation across all pages:

  • Theme: switched from sphinx-rtd-theme to furo; cleaned up conf.py (fixed sys.path, removed duplicate extensions list, added intersphinx mappings for NumPy/SciPy/ASE/Python)
  • index.rst: replaced placeholder description with a proper project summary and feature list; reordered toctree so Examples comes before API
  • installation.rst: added hyperlinks to dependencies, added missing RDKit requirement, added ML calculator table (AIMNet2, MACE, FAIR UMA, xTB, Q-Chem) with install instructions; fixed RST syntax error in AIMNet2 code-block
  • api.rst: rewrote module entries with short plain-English descriptions; reordered to lead with FreezingString
  • examples.rst: replaced stub with full worked examples (EMT quick-start, fixed atoms, explicit step size, interpolation method table, UMA example, benchmark reaction table)

To review before merging:

  1. Check out the branch
  2. Run pixi shell -e dev && pixi run docs
  3. Open docs/build/index.html in your browser

Feel free to merge when approved/happy

@jonmarks12
jonmarks12 requested a review from joegomes April 5, 2026 10:48
Comment thread docs/source/examples.rst
Comment thread docs/source/examples.rst Outdated
Comment thread docs/source/installation.rst Outdated
Comment thread docs/source/installation.rst

@joegomes joegomes left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a huge improvement to the documentation! I only a had a few minor comments to address

Comment thread docs/source/examples.rst
@jonmarks12
jonmarks12 merged commit 339bf13 into main Apr 7, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants